package com.ybwh.springboot2.exmple.service;

import com.ybwh.springboot2.exmple.entity.Dict;

import java.io.Serializable;
import java.util.Collection;
import java.util.List;

/**
 * <p>
 * 字典表 服务类
 * </p>
 *
 * @author fanbeibei
 * @since 2023-07-12
 */
public interface DictService {

    /**
     * 之所以要生成以下方法而不直接用mybatis-plus的原始方法，是为了方便追溯某个mapper调用代码,
     * 避免find use后找出一批无关的代码
     */

    /**
     * 插入一条记录
     *
     * @param entity 实体对象
     */
    int insert(Dict entity);

    /**
     * 根据 ID 删除
     *
     * @param id 主键ID
     */
    int deleteById(Serializable id);

    /**
     * 删除（根据ID 批量删除）
     *
     * @param idList 主键ID列表(不能为 null 以及 empty)
     */
    int deleteBatchIds(Collection<? extends Serializable> idList);

    /**
     * 根据 ID 修改
     *
     * @param entity 实体对象
     */
    int updateById(Dict entity);

    /**
     * 根据 ID 查询
     *
     * @param id 主键ID
     */
    Dict selectById(Serializable id);

    /**
     * 查询（根据ID 批量查询）
     *
     * @param idList 主键ID列表(不能为 null 以及 empty)
     */
    List<Dict> selectBatchIds(Collection<? extends Serializable> idList);


    void forceUpdateTransaction();


    /**
     * 根据id强制更新用setter设过值的属性,哪怕设为null,没有用setter设置的属性不更新
     * 例子：
     * <pre>{@code
     *   Dict dict = UpdateEntity.of(Dict.class,1L);
     * 	 dict.setDictDescr("33333");
     * 	 dict.setDictGroup(null);
     * 	 dictService.forceUpdateById(dict);
     *
     * }
     * </pre>
     *
     * @param dict
     */
    void forceUpdateById(Dict dict);
}
